org.jvnet.flamingo.ribbon
Class JRibbonComponent

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              org.jvnet.flamingo.common.RichToolTipManager.JTrackableComponent
                  org.jvnet.flamingo.ribbon.JRibbonComponent

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable

public class JRibbonComponent
extends RichToolTipManager.JTrackableComponent

Wrapper around core and 3rd party Swing controls to allow placing them in the JRibbonBand.

Author:

Kirill Grouchnikov

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Field Summary

static java.lang.String

uiClassID The UI class ID string.

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

JRibbonComponent(javax.swing.JComponent mainComponent)
Creates a simple wrapper with no icon and no caption.

JRibbonComponent(ResizableIcon icon, java.lang.String caption, javax.swing.JComponent mainComponent)
Creates a wrapper with an icon and a caption.

Method Summary

java.lang.String	getCaption() Returns the wrapper caption of this wrapper component.
HorizontalAlignment	getHorizontalAlignment() Returns the horizontal alignment for this wrapper component.
ResizableIcon	getIcon() Returns the wrapper icon of this wrapper component.
java.lang.String	getKeyTip() Returns the key tip for this wrapper component.
javax.swing.JComponent	getMainComponent() Returns the wrapped component of this wrapper component.
RichTooltip	getRichTooltip(java.awt.event.MouseEvent mouseEvent)
RibbonComponentUI	getUI() Returns the UI object which implements the L&F for this component.
java.lang.String	getUIClassID()
boolean	isSimpleWrapper() Returns indication whether this wrapper is simple.
void	setHorizontalAlignment(HorizontalAlignment horizontalAlignment) Sets the specified parameter to be the horizontal alignment for this wrapper component.
void	setKeyTip(java.lang.String keyTip) Sets the specified string to be the key tip for this wrapper component.
void	setRichTooltip(RichTooltip richTooltip) Sets the rich tooltip for this wrapper component.
void	updateUI()

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

uiClassID

public static final java.lang.String uiClassID

The UI class ID string.

See Also:

Constant Field Values

Constructor Detail

JRibbonComponent

public JRibbonComponent(javax.swing.JComponent mainComponent)

Creates a simple wrapper with no icon and no caption.

Parameters:

mainComponent - Wrapped component. Can not be null.

Throws:

java.lang.IllegalArgumentException - if mainComponent is null.

JRibbonComponent

public JRibbonComponent(ResizableIcon icon,
                        java.lang.String caption,
                        javax.swing.JComponent mainComponent)

Creates a wrapper with an icon and a caption.

Parameters:

icon - Wrapper icon. Can be null.

caption - Wrapper caption. Can not be null.

mainComponent - Wrapped component. Can not be null.

Throws:

java.lang.IllegalArgumentException - if caption or mainComponent is null.

Method Detail

updateUI

public void updateUI()

Overrides:

updateUI in class javax.swing.JComponent

getUIClassID

public java.lang.String getUIClassID()

Overrides:

getUIClassID in class javax.swing.JComponent

getUI

public RibbonComponentUI getUI()

Returns the UI object which implements the L&F for this component.

Returns:

a RibbonUI object

See Also:

JComponent.setUI(javax.swing.plaf.ComponentUI)

getIcon

public ResizableIcon getIcon()

Returns the wrapper icon of this wrapper component. Can return null.

Returns:

The wrapper icon of this wrapper component.

See Also:

JRibbonComponent(ResizableIcon, String, JComponent)

getCaption

public java.lang.String getCaption()

Returns the wrapper caption of this wrapper component. Can return null.

Returns:

The wrapper caption of this wrapper component.

See Also:

JRibbonComponent(ResizableIcon, String, JComponent)

getMainComponent

public javax.swing.JComponent getMainComponent()

Returns the wrapped component of this wrapper component. The result is guaranteed to be non null.

Returns:

The wrapped component of this wrapper component.

isSimpleWrapper

public boolean isSimpleWrapper()

Returns indication whether this wrapper is simple.

Returns:

true if both getIcon() and getCaption() return null, false otherwise.

getKeyTip

public java.lang.String getKeyTip()

Returns the key tip for this wrapper component.

Returns:

The key tip for this wrapper component.

See Also:

setKeyTip(String)

setKeyTip

public void setKeyTip(java.lang.String keyTip)

Sets the specified string to be the key tip for this wrapper component. Fires a keyTip property change event.

Parameters:

keyTip - The new key tip for this wrapper component.

getRichTooltip

public RichTooltip getRichTooltip(java.awt.event.MouseEvent mouseEvent)

Specified by:

getRichTooltip in class RichToolTipManager.JTrackableComponent

setRichTooltip

public void setRichTooltip(RichTooltip richTooltip)

Sets the rich tooltip for this wrapper component.

Parameters:

richTooltip -

See Also:

getRichTooltip(MouseEvent)

getHorizontalAlignment

public HorizontalAlignment getHorizontalAlignment()

Returns the horizontal alignment for this wrapper component.

Returns:

The horizontal alignment for this wrapper component.

See Also:

setHorizontalAlignment(HorizontalAlignment)

setHorizontalAlignment

public void setHorizontalAlignment(HorizontalAlignment horizontalAlignment)

Sets the specified parameter to be the horizontal alignment for this wrapper component.

Parameters:

horizontalAlignment - The new horizontal alignment for this wrapper component.

See Also:

getHorizontalAlignment()